home *** CD-ROM | disk | FTP | other *** search
/ Leisure Game Pak 1 / Leisure Game Pak I.iso / mod / pmp.doc < prev    next >
Text File  |  1994-08-17  |  11KB  |  237 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.      ──────────────────────────────────────────────────────────────────────
  9.      Protected Module Player PMP (C) 1993 Jussi Lahdenniemi and Otto Chrons
  10.      ──────────────────────────────────────────────────────────────────────
  11.  
  12.                                   Version 2.24
  13.  
  14.  
  15.  
  16.  
  17.  
  18.         Like the DMP, also PMP is just a demonstration about the possibilities
  19.      of the DSMI (Digital Sound and Music Interface). It is a module player,
  20.      which runs in the protected mode, offering lots of memory for the modules
  21.      to use. Also, because of this, the PMP gives you a fully-working DOS
  22.      shell, and takes only about 40k of memory regardless of the size of
  23.      the module! So, you can play a 700k module and still have over 550k of
  24.      memory free! If your computer is in the v86-mode (ie. you have a program
  25.      like QEMM installed) the PMP takes a little more memory (24k more),
  26.      because the buffers must reside in the low memory.
  27.  
  28.         The command line syntax of the PMP is just the same as DMP's :
  29.  
  30.            PMP [options] [modulename] [@listfile] [options]
  31.  
  32.            Where:
  33.            ------
  34.        modulename : name of a module (wildcards *,? allowed)
  35.        listfile   : name of a file containing list of module names
  36.  
  37.        options  : -Sxxxx          set sampling rate 4000-44100
  38.                       alternatively 4-44
  39.                       DON'T USE HIGHER THAN 21kHz ON A SB
  40.               -H or -?          show help screen
  41.               -Ix          interrupt number
  42.               -Pxxx          port address
  43.               -Dx          DMA channel
  44.               -O          Scramble module order
  45.               -L          Inhibit looping
  46.                       -M              Mono mode (SB16 & PAS)
  47.               -Q          Quality mode (on 8-bit cards only)
  48.                       -B              Remove the volume bars
  49.                       -Cx             Desired card where x is:
  50.                     1 for Sound Blaster
  51.                     2 for Sound Blaster Pro
  52.                     3 for PAS+
  53.                     4 for PAS16
  54.                     5 for SB16
  55.                       -T[xxx]         Buffer size xxx (0-32000)
  56.                       -Fxxx           Force PMP to leave xxx kilobytes
  57.                                       of memory for the DOS shell
  58.                       -V              Force PMP to use its v86 mode support
  59.                                       (place the buffers to low memory)
  60.  
  61.         You may have to  give your soundcard's IRQ  number and/or
  62.      port address if PMP fails to find them. If you don't provide both
  63.      values then PMP will assume 220h for port address, and 7 for interrupt
  64.      number. Giving  wrong address  will hang  your machine,  but wrong
  65.      interrupt number only stops the playing after a second. The "/C"
  66.      option is useful if you want to use some other card, than the one PMP
  67.      automatically detects.
  68.  
  69.         You don't  have  to add  any extension  to  the name,  because the
  70.      program will try  extensions AMF, STM, MOD and  NST if it  doesn't find
  71.      the file. Note that you can supply many modulenames and list files, up
  72.      to the internal limit of 200 modulenames.
  73.  
  74.            Example:
  75.  
  76.        PMP beyond -s20 *.NST @goodmods
  77.  
  78.            goodmods is a text file containing following lines:
  79.            occ-san
  80.            stars
  81.            intro3
  82.  
  83.         PMP  will use  the  sampling  rate  of  20kHz  and  play following
  84.      modules: BEYOND.MOD,  OCC-SAN.STM, STARS.MOD, INTRO3.MOD  and all
  85.      .NST-files in the current directory.
  86.  
  87.         The above text was taken straight from the DMP's documentation. As you
  88.      can see: If you can use DMP, you can use PMP...
  89.  
  90.         Normally PMP uses all free XMS memory for its own purposes, but if you
  91.      want to save some XMS for other programs, use the environment variable
  92.      DPMIMEM:
  93.  
  94.      SET DPMIMEM=MAXMEM 1024
  95.  
  96.      limits the XMS use to one MB.
  97.  
  98.         Note : Borland's programs that run in the protected mode use also
  99.      this environment variable.
  100.  
  101.         Another supported environment variable is PMP. You can write your
  102.      preferred settings into the variable, so you don't have to write them
  103.      every time you start the program. For example, if you have the PMP
  104.      variable set as follows:
  105.  
  106.      SET PMP=/S30 /O C:\MODS\*.MOD
  107.  
  108.      and then you run PMP like this:
  109.  
  110.      PMP *.stm
  111.  
  112.      PMP will be started just like if you had written
  113.      PMP /S30 /O C:\MODS\*.MOD *.stm
  114.      from the command line.
  115.  
  116.  
  117.  !!!!   The included files RTM.EXE and DPMI16BI.OVL must be in the path!   !!!!
  118.  
  119.  
  120.                             Using PMP
  121.                             ---------
  122.  
  123.         There is a header in the top of the screen telling what program you
  124.      are using and other important info. In the right side of the screen
  125.      there is a big blue box with all the module names you have selected
  126.      in the command line. When a module is loaded into memory, it is marked.
  127.      That way it is easy to see which modules are to be played next, and
  128.      which modules are loaded. There is also a big brown box on the bottom
  129.      of the screen containing all the instruments used in the module.
  130.         The volume bars are made with palette, and they demand really lots
  131.      of CPU power. They flicker easily even in fast machines. I am sorry,
  132.      but buy a faster machine if the bars don't work.. ;)  - or press B.
  133.         After initializing everything it needs, PMP starts to load the first
  134.      module. After loading it, PMP starts to play the module and proceeds
  135.      with loading the next module. It loads as many modules as possible,
  136.      and then plays them from memory. If all the modules you selected do
  137.      not fit to the memory, PMP discards the module after playing it and
  138.      loads more modules. With the /F switch you can control the memory
  139.      allocation so that you always will have enough memory to shell to DOS.
  140.         While playing under PMP (not in the DOS shell), there is a status
  141.      bar just below the header text. This status bar shows the pattern
  142.      currently being played, the total number of patterns, the current row,
  143.      the master volume level, and indicators indicating which channels are
  144.      being played. It also helps you by telling that help is available by the
  145.      H key. The help screen that pops up as you press H is the same that the
  146.      /? or /H command line switch shows.
  147.  
  148.      Keys while the module is being played :
  149.  
  150.        Key        Meaning                              Also in DOS shell
  151.        ---        -------                              -----------------
  152.  
  153.        P          Pauses / resumes the module          alt-F11
  154.        N          Next module                          alt-F12
  155.        H,?        Help screen
  156.        D          DOS shell (with lots of memory!)
  157.        C          Clear the information screen
  158.        S          Toggle SB Pro stereo mode on/off
  159.        B          Toggle the volume bars on/off
  160.        F1-F10     Set the master volume
  161.        +,-        Change the master volume one step    shift-F11, shift-F12
  162.        Left,Right Jump to next/previous pattern        ctrl-F11, ctrl-F12
  163.        Up,Down    Scroll module list window
  164.        1,2,..     Turn track on/off
  165.  
  166.  
  167.  
  168.                          Contacting the authors
  169.                          ----------------------
  170.  
  171.        If you have questions or comments about the PMP or the Pascal version
  172.     of the DSMI, contact Jussi Lahdenniemi:
  173.  
  174.        ┌─────────────────────────────────────────────────────────────────────┐
  175.        │                                                                     │
  176.        │   By mail:                                                          │
  177.        │   ────────                                                          │
  178.        │                                                                     │
  179.        │            Jussi Lahdenniemi                                        │
  180.        │            Rautia                                                   │
  181.        │            SF-36420 Sahalahti                                       │
  182.        │            FINLAND                                                  │
  183.        │                                                                     │
  184.        │   Fidonet:                                                          │
  185.        │   ─────────                                                         │
  186.        │            2:221/105.7                                              │
  187.        │                                                                     │
  188.        │   InterNet:                                                         │
  189.        │   ──────────                                                        │
  190.        │            avatar@salpu.fipnet.fi                                   │
  191.        │                                                                     │
  192.        └─────────────────────────────────────────────────────────────────────┘
  193.  
  194.  
  195.  
  196.        To comment about the DMP or the C or ASM versions of the DSMI, contact
  197.     Otto Chrons :
  198.  
  199.        ┌─────────────────────────────────────────────────────────────────────┐
  200.        │                                                                     │
  201.        │   By mail:                                                          │
  202.        │   ────────                                                          │
  203.        │                                                                     │
  204.        │            Otto Chrons                                              │
  205.        │            Pyydyspolku 5                                            │
  206.        │            SF-36200 Kangasala                                       │
  207.        │            FINLAND                                                  │
  208.        │                                                                     │
  209.        │   Fidonet:                                                          │
  210.        │   ─────────                                                         │
  211.        │        2:221/105.10                         │
  212.        │                                                                     │
  213.        │   InterNet:                                                         │
  214.        │   ──────────                                                        │
  215.        │            c142092@cc.tut.fi (fastest method to contact)            │
  216.        │                                                                     │
  217.        └─────────────────────────────────────────────────────────────────────┘
  218.  
  219.  
  220.  
  221.  
  222.                              For programmers only
  223.                              --------------------
  224.  
  225.  
  226.            PMP was  created with  Borland Pascal 7.0 and  it is  based on
  227.  DSMI routines, so by ordering DSMI interface you could write programs
  228.  with similar capabilities. DSMI is a collection of  routines (for C and
  229.  Turbo/Borland Pascal) that allows programmers to play  modules in the
  230.  background, but unlike any other module player it also allows
  231.  simultaneous sound effects!! Up to 32 channels can be used which means
  232.  that you can have a module and sound effects playing in full stereo (on
  233.  cards which support stereo sound)! DSMI is available and the price is
  234.  270FMK (about $70). Packet includes full documentation (printed), OBJ
  235.  files & libraries for C version, TPUs for Pascal and also some of the
  236.  source code so you can modify the behaviour of DSMI. Stay tuned!
  237.